home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1996 June
/
EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso
/
earcd
/
gcc
/
ixemlsrc.lha
/
ixemul
/
INSTALL
< prev
next >
Wrap
Text File
|
1996-03-26
|
8KB
|
194 lines
IXEMUL LIBRARY INSTALLATION NOTES
(last updated 9-Jan-96)
=====================
DISTRIBUTION CONTENTS
=====================
The net ixemul library distribution consists of several archives:
ixemul-bin.lha Utils for gnu/bin, like ixtrace and ixconfig
ixemul-sdk.lha Files needed to build applications that use
ixemul.library.
ixemul-doc.lha Various documentation, such as this file
ixemul-src.tgz Complete source code for ixemul library as
a gzip compressed tar archive.
ixemul-tz.lha Pieces for doing TZ (timezone) management
ixemul-CCCF.lha Specific flavors of the library, where 'CCC'
is one of 000, 020, 030, or 040, for 68000, 68020,
68030, and 68040 respectively, and 'F' is either
'f', 's', or 't' for FPU support or soft floating
point or a "trace" version (also soft float)
respectively.
The ixemul-doc.lha archive contains various readme and copyright files that
do not need to be installed anywhere. The ixemul-src.tgz archive contains
the source tree that can be installed anywhere. The rest of the archives
should simply be extracted relative to the gnu: directory to put all the
files in their standard location.
========================
INSTALLING RUNTIME FILES
========================
For the moment, you must manually install the files. Eventually there will
be an installer script available that you can use with the standard AmigaDOS
installer program to make installation more WorkBench friendly.
First backup any files in gnu: that will get overwritten during the install,
if you wish to preserve them. These files typically are:
gnu:bin/ixconfig
gnu:bin/ixtrace
gnu:lib/bcrt0.o
gnu:lib/crt0.o
gnu:lib/rcrt0.o
gnu:lib/libc.a
gnu:lib/libb/libc.a
gnu:include (lots of files, but probably not all)
gnu:man (lots of files, but probably not all)
gnu:etc (lots of files, but probably not all)
gnu:Sys/libs/ixemul* (all the old versions of the library)
Change directory to gnu: and extract the contents of ixemul-bin.lha,
ixemul-sdk.lha (if you expect to be building any ixemul.library using
applications), ixemul-tz.lha (optional) and any ixemul-XXXX.lha archives
that you want, overwriting any existing copies of the files in your gnu
tree. For example, to install the utils, sdk, and both the 68000 and
68040+68881 versions of the library, do the following:
lha -mraxe x ixemul-bin.lha gnu:
lha -mraxe x ixemul-sdk.lha gnu:
lha -mraxe x ixemul-000.lha gnu:
lha -mraxe x ixemul-040f.lha gnu:
Now you need to decide which version of the library to use, based on what
sort of machine you have (68000, 68020, 68030, 68040) and whether or not it
has an FPU (68020+68881, 68030 with FPU, or 68040 with FPU). Do something
like the following:
cd gnu:Sys/libs
copy ixemul040fpu.library ixemul.library clone
Then either reboot or run a program to flush the existing ixemul.library (if
any) from memory. You might also want to review the NEWS file from the docs
archive for changes made since the version from which you have upgraded.
If you installed the ixemul-tz.lha archive you should read ixtimezone.doc
from the docs archive and set your TZ environment variable appropriately.
=======================
INSTALLING SOURCE FILES
=======================
To extract the source code, simply cd to a directory where you would like
the source code directory to be created, and extract the source archive
there:
cd gnu-src:
gzip -d ixemul-src.tgz
tar -xvf ixemul-src.tar
rm ixemul-src.tar
Note that this will create the directory ixemul and populate it with all the
source files.
To rebuild the library, all that is needed is to run the configure script
and then run make. It is recommended that you use separate source and build
directories so you can leave the source tree untouched:
cd gnu-build:
makedir ixemul
cd ixemul
sh /gnu-src/ixemul/configure
This will create a Makefile and several subdirectories with other Makefiles.
Note the section in the Makefile that looks like:
all:
$(MAKE) build CPU=68000 FPU=soft-float BASE=no-baserel
$(MAKE) build CPU=68000 FPU=soft-float BASE=baserel
$(MAKE) build CPU=68020 FPU=68881 BASE=no-baserel
$(MAKE) build CPU=68020 FPU=68881 BASE=baserel
$(MAKE) build CPU=68020 FPU=soft-float BASE=no-baserel
$(MAKE) build CPU=68020 FPU=soft-float BASE=baserel
$(MAKE) build CPU=68030 FPU=68881 BASE=no-baserel
$(MAKE) build CPU=68030 FPU=68881 BASE=baserel
$(MAKE) build CPU=68030 FPU=soft-float BASE=no-baserel
$(MAKE) build CPU=68030 FPU=soft-float BASE=baserel
$(MAKE) build CPU=68040 FPU=68881 BASE=no-baserel
$(MAKE) build CPU=68040 FPU=68881 BASE=baserel
@(cd libsrc && $(MAKE) $(FLAGS_TO_PASS))
By default, all of the versions of ixemul.library are built by make. This
can take a relatively long time. If you only want to build one particular
version of the library and runtime files to test, just comment out the lines
you don't want. I.E. to build a 68040+68881 version, the above lines
should be changed to:
all:
$(MAKE) build CPU=68000 FPU=soft-float BASE=no-baserel
$(MAKE) build CPU=68000 FPU=soft-float BASE=baserel
# $(MAKE) build CPU=68020 FPU=68881 BASE=no-baserel
# $(MAKE) build CPU=68020 FPU=68881 BASE=baserel
# $(MAKE) build CPU=68020 FPU=soft-float BASE=no-baserel
# $(MAKE) build CPU=68020 FPU=soft-float BASE=baserel
# $(MAKE) build CPU=68030 FPU=68881 BASE=no-baserel
# $(MAKE) build CPU=68030 FPU=68881 BASE=baserel
# $(MAKE) build CPU=68030 FPU=soft-float BASE=no-baserel
# $(MAKE) build CPU=68030 FPU=soft-float BASE=baserel
$(MAKE) build CPU=68040 FPU=68881 BASE=no-baserel
$(MAKE) build CPU=68040 FPU=68881 BASE=baserel
@(cd libsrc && $(MAKE) $(FLAGS_TO_PASS))
Note that you have to build the 68000 version in any case, since the
compiler runtime files (*crt*.o, libc.a, libbc.a) are generic 68000 code.
Then just run "make" in the build directory:
cd gnu-build:ixemul
make
Note that you must have a version of GNU make that is newer than the ones
distributed on the FreshFish CDs and on aminet. Those makes had a patch for
AmigaDOS that nobody used but disabled an important feature that the current
ixemul Makefiles use. If you have problem compiling the ixemul library get
the lastest ADE make from ftp.amigalib.com:pub/ade or a mirror.
You also need at least version 2.6.0 of gas, the GNU assembler. Earlier
versions didn't fully support the Motorola assembly syntax, but this one
does. Again, you can get this from ADE.
Finally, if you have an older version of ixemul.library installed while you
are compiling this new version, then you may run into trouble building the
timezone files using the 'zic' utility. This utility requires the latest
ixemul.library (which you have just compiled), but since you haven't
installed it yet, zic complains that the ixemul.library is too old. The
solution is to install the new ixemul.library first, and then continue
compiling. You may have to use 'avail flush' or reboot after installing the
new library to insure that the old library is really flushed from memory.
=======
IXPREFS
=======
Note that effective with ixemul.library 42.0, ixconfig can no longer be
used. Use ixprefs instead.
==============
REPORTING BUGS
==============
Please report problems or bugs to Hans Verkuil (hans@wyst.hobby.nl), who is
the current ixemul library coordinator. Even better than a bug report is a
bug fix, which typically would be a context diff file for one or more ixemul
source files.